home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 126-150 / scopedisk143 / vlt4.824 / docs / vlt4p058.doc < prev    next >
Text File  |  1995-03-19  |  36KB  |  799 lines
  1. +----------------------------------------------------------------------+
  2. |                                                                      |
  3. |                  D I S C L A I M E R   N O T I C E                   |
  4. |                                                                      |
  5. |  This document and/or  portions of the material and  data furnished  |
  6. |  herewith,  was developed under sponsorship of the U.S. Government.  |
  7. |  Neither the U.S.  nor  the U.S.D.O.E.,  nor  the  Leland  Stanford  |
  8. |  Junior University, nor their employees,  nor their respective con-  |
  9. |  tractors, subcontractors, or their employees, makes  any warranty,  |
  10. |  express or implied, or assumes any liability or responsibility for  |
  11. |  accuracy,  completeness or  usefulness of any information, appara-  |
  12. |  tus, product or process disclosed, or represents that its use will  |
  13. |  not infringe privately-owned rights.  Mention of any product,  its  |
  14. |  manufacturer, or suppliers shall not, nor is it intended to, imply  |
  15. |  approval, disapproval, or fitness for any particular use. The U.S.  |
  16. |  and  the University at all times  retain the right to use and dis-  |
  17. |  seminate same for any purpose whatsoever.                           |
  18. |                                                                      |
  19. +----------------------------------------------------------------------+
  20.  
  21.  
  22.                 VLT 4.058  Additional Documentation
  23.                 ===================================
  24.  
  25.                         (C) Copyright 1989
  26.  
  27.                                by
  28.  
  29.                         W.G.J. Langeveld
  30.  
  31.                 Stanford Linear Accelerator Center
  32.  
  33.  
  34. With 4.058:
  35. ===========
  36.  
  37.     See Readme file in root directory for changes made since version
  38. 4.036.
  39.  
  40.     W.G.J. Langeveld, 16 July 1989.
  41.  
  42.  
  43. Introduction
  44. ============
  45.  
  46.         This document describes the various enhancements that have been
  47. made to VLT over the past six months, from version 3.656 to the present
  48. version 4.036 . Since there have been quite a few changes, I will give a
  49. brief description of most of it from scratch. More details will be found in
  50. a new manual that I'll be working on in the future.
  51.         Some features people have asked for have not yet been implemented
  52. for lack of time: it seemed better to release the current version first and
  53. then add some more things. Most notably, the scripting facility has not yet
  54. been rewritten, and therefore certain limitations to the ARexx interface
  55. are still present. On the other hand, many features people have *not* asked
  56. for, are now in place...
  57.         Section 1 describes what the menus of both alpha-numeric and
  58. Tektronix screens do (very briefly). I will indicate at each point what is
  59. new by ***> three-asterisk arrows <***. Section 2 gives a list of the
  60. script commands with their arguments and limitations. Section 3 will give
  61. some more detail on various other changes and will list some bugs that were
  62. fixed.
  63.         For any questions or bug reports contact me on BIX, user ID
  64. langeveld, or at SLAC, extension 2280.
  65.  
  66.  
  67. 1. VLT's Menus
  68. ==============
  69.  
  70.         Quite a few menu items were added. The behavior of the existing
  71. menu items was in some cases changed, so be careful! In the descriptions,
  72. where applicable, the corresponding right-Amiga sequence is given in
  73. parentheses.
  74.  
  75. 1.1 VLT menu
  76. ------------
  77.  
  78. - Capture Session (O)   When first selected, diplays a file requester to enter
  79.                         a capture file name.
  80.                         ***> If the file exists, a requester appears asking
  81.                         whether it is okay to overwrite it, if the answer is
  82.                         No, a requester appears asking whether you want to
  83.                         append to it. <***
  84.                         Subsequent selections of this option toggle between
  85.                         Suspend Capture and Resume Capture.
  86.  
  87. - End Capture     (E)   Closes the capture file.
  88.  
  89. - Open Console          ***> Opens a small four line console ("chat") window
  90.                         at the bottom of the screen, if ConMan is installed.
  91.                         Provides command history and editing. Allows execution
  92.                         of VLT script commands by prefixing command with key
  93.                         script character. Disadvantages: line oriented, no
  94.                         access to VLT menus. <***.
  95.  
  96. - Save Configuration    Save the file VTPrefs.dat in current directory or s:.
  97.  
  98. - Version         (V)   Display VLT version number.
  99.  
  100. - Exit                  Exit VLT.
  101.  
  102.  
  103. 1.2 Comm menu
  104. -------------
  105.  
  106. - Select Device         ***> Select a different serial device (used with, e.g.
  107.                         ASDG's Twin-X serial boards). First a file requester
  108.                         will appear to select the device, then a string 
  109.                         requester to select the unit number. <***
  110.  
  111. - Select Unit           ***> Select a different unit number for the currently
  112.                         selected serial device. <***
  113.  
  114. - Baud                  Select the baud rate.
  115.   -   110                       ***> 110 baud is now supported. <***
  116.   -  ...
  117.   - 19200
  118.  
  119. - Parity                Select parity, wordlength, number of stop bits.
  120.   - 8N1
  121.   - ...
  122.   - 7O2
  123.  
  124. - Protocol              Select handshake protocol.
  125.   - None
  126.   - xON/xOFF
  127.   - 7-Wire
  128.   - 7-Wire/X
  129.  
  130. - Send Break (B)        Send a break.
  131.  
  132. - Hangup     (H)        Drop carrier for one second.
  133.  
  134. - Echo                  Switch local echo on or off.
  135.   - Off (*)             
  136.   - On  (+)
  137.  
  138. - Strip Bit 8           ***> Enable/disable masking of the 8th bit on 
  139.   - Off                 parity/wordlength settings that allow 8 data
  140.   - On                  bits. <***
  141.  
  142. - Set Break Time        ***> Set break time (micro-seconds). <***
  143.  
  144. - Set Buffer Size       ***> Set buffer size (bytes). <***
  145.  
  146.  
  147. 1.3 Transfer Menu
  148. -----------------
  149.  
  150. - Send File    (S)      Send file using current protocol
  151.  
  152. - Receive File (R)      Receive file using current protocol
  153.  
  154. - Protocol              Select type of protocol
  155.   - External   (T)             ***> External protocols are now supported. <***
  156.   - Kermit     (K)
  157.   - XMODEM     (X)
  158.  
  159. - Kermit Options        Select options for Kermit.
  160.   - Send/Receive     (-)
  161.   - Host is Server   (=)
  162.   - Change Directory (D)        Set default directory for received files.
  163.   - Kermit Bye       (Y)        Send a Kermit Bye command.
  164.  
  165. - XMODEM Options        Select options for XMODEM
  166.   - Checksum         ([)
  167.   - Checksum / 1K Blocks
  168.   - CRC
  169.   - CRC / 1K Blocks  (])
  170.  
  171. - External Options      ***> Enter options for external protocol (only 
  172.                         active when external protocol is selected). <***
  173.  
  174. - Translate Options     Select various translation options.
  175.   - No Translation      (,)
  176.   - CR/LF -> LF         (.)     Convert cr/lf pairs to lf.
  177.   - Downcase File Names (/)     Downcase file names when receiving files.
  178.  
  179.  
  180. 1.4 Macros Menu
  181. ---------------
  182.  
  183. - ARexx Macro (A)       Execute an ARexx macro.
  184.  
  185. - VLT Macro   (M)       Execute a VLT script
  186.  
  187. - Abort VLT Macro       Abort a VLT script (cannot be used for ARexx macros).
  188.  
  189. - Keyboard Macros       This menu item makes right-amiga 1, 2,... 0
  190.   -  1  (1)             programmable key strokes.
  191.   - ...
  192.   -  0  (0)
  193.  
  194. - Program Mode          Switch program mode on/off. In program mode, all
  195.   - On   (()            function keys can be programmed, ***> as well as
  196.   - Off  ())            what the Beep function should do. <***
  197.  
  198.  
  199. 1.5 Screen Menu
  200. ---------------
  201.  
  202. - Clear Screen      (C) Erase the screen contents.
  203.  
  204. - Screen to Back    (J) Move VLT to the back of all other screen/windows.
  205.  
  206. - Select Screen Type    Select screen type.
  207.   - Custom Screen
  208.   - Workbench
  209.   - Interlaced
  210.   - Non-Interlaced
  211.  
  212. - Number of Colors      Select the number of colors.
  213.   - 2
  214.   - 4
  215.   - 8
  216.  
  217. - Select Colors     (U) Brings up a Palette requester to adjust the screen
  218.                         colors.
  219.  
  220. - Number of Lines   (L) Set the number of lines to aim for. ***> This 
  221.                         option no longer shows the actual number of lines
  222.                         but the requested number instead. This means that
  223.                         resizing the screen/window no longer loses the
  224.                         requested number of lines, and when possible, this
  225.                         number of lines is indeed displayed. <***
  226.  
  227. - Number of Columns (Z) Set the number of columns to aim for. ***> Similar
  228.                         changes were made as for the number of lines. <***
  229.  
  230. - Amount of Prescroll   Sets the maximum number of lines to scroll in case
  231.                         look-ahead has determined multiple line scrolls
  232.                         are needed.
  233.  
  234. - Cursor Height         ***> Set the block cursor's height in pixels. <***
  235.  
  236. - Rendering Mode        Select the way in which text updates take place.
  237.   - Quick    (Q)                Fastest mode, uses 1 bitplane.
  238.   - Normal   (N)                Same, using second bitplane for BOLD.
  239.   - Color    (G)                Use colors instead of bold, italic, etc.
  240.   - ANSI Color                  ***> Use ANSI color sequences "properly".
  241.                                 "Color" mode recognizes ANSI colors, but
  242.                                 uses some of them in non-standard ways.
  243.                                 The ANSI switch can be set at the same time
  244.                                 to inhibit the non-standard behavior. <***
  245.  
  246. 1.6 Operation Menu
  247. ------------------
  248.  
  249.         These options, when selected, do the following:
  250.  
  251. - Wrap                 (W) Wrap lines longer than current columns seting.
  252.  
  253. - Numeric Keypad           Keypad sends numeric values, not escape sequences.
  254.  
  255. - Application Cursor       Cursor keypad sends application style sequences.
  256.  
  257. - Swap BS <-> Delete   (I) Reverse the meaning of Backspace and Delete keys.
  258.  
  259. - Destructive BS           Make backspace destructive in local echo mode.
  260.  
  261. - Help Key = LF            Help key sens Linefeed.
  262.  
  263. - Shift TAB = ESC TAB      Shifted TAB key sends <ESC> <TAB>
  264.  
  265. - Function Key Gadgets (P) Display function key gadgets at bottom of screen.
  266.  
  267. - Mouse Support        (\) Clicking mouse sends arrow-key sequences.
  268.  
  269. - Beep Volume              Adjust volume of built-in beep. Volume of 0
  270.                            flashes the screen instead. Negative values
  271.                            give different pitch. ***> In program mode, a 
  272.                            Beep Command can be entered, allowing arbitrary
  273.                            things to be executed on receipt of a beep. <***
  274.  
  275. - CR-Key: Echo CR/LF       ***> In local echo, echo CR and LF when CR is
  276.                            pressed. <***
  277.  
  278. - CR-Key: Send CR/LF       ***> Send CR and LF when CR is pressed. <***
  279.  
  280. - Auto-Screen to Back      ***> During file transfers, bring the Workbench to
  281.                            the front and display the status window there. <***
  282.  
  283.  
  284. 1.7 Graphics Menu
  285. -----------------
  286.  
  287. - Lock Graphics (;)     Disallow switching to the graphics screen when
  288.                         receiving Tektronix control characters.
  289.  
  290. - To Graphics   (F)     Display the graphics screen.
  291.  
  292.  
  293. 1.8  (Tek) Image Menu
  294. ---------------------
  295.  
  296. - Save To Current File     (S)  Save vector file to currently designated file.
  297.  
  298. - Save To New File         (A)  Save vector file to disk.
  299.  
  300. - Load From Archive        (L)  Load a vector file from disk.
  301.  
  302. - Quit Archive             (Q)  Stop viewing a vector file and redisplay.
  303.  
  304. - Save Bitmap As IFF File  (I)  ***> Save current image as an IFF file. <***
  305.  
  306. - Print Bitmap                  ***> Print current image to an attached
  307.   - Maximum Size           (()  printer as a bitmap graphics dump in one
  308.   - 1/3 Page               ())  of four different sizes. <***
  309.   - 2/3 Page               (/)
  310.   - Full Page              (*)
  311.  
  312. - Save/Print as PostScript® (E) ***> Save vector file in PostScript® format
  313.                                 (saving to par: will print it if a PS printer
  314.                                 is attached). <***
  315.  
  316.  
  317. 1.9  (Tek) Zoom/Pan Menu
  318. ------------------------
  319.  
  320. - Select Zoom Area (Z)          Set up for a Zoom operation.
  321.  
  322. - Select Pan  Area (P)          Set up for a Pan operation.
  323.  
  324. - Reset Zoom/Pan   (R)          Reset Zoom/Pan to default.
  325.  
  326.  
  327. 1.10 (Tek) Cursor Menu
  328. ----------------------
  329.  
  330. - Switch Graphic Cursor On  (X) Display the Graphic cursor.
  331.  
  332. - Switch Graphic Cursor Off (Y) Remove the Graphic cursor.
  333.  
  334. - Display Cross Hair Only   (H) When on, only show the cross hair.
  335.  
  336. - Display Cross Hair + XY   (N) When on, show both cross hair and the current
  337.                                 X,Y position ***> in a separate window. <***
  338.  
  339.  
  340. 1.11 (Tek) Screen Menu
  341. ----------------------
  342.  
  343. - Clear Screen      (C) Erase the screen contents.
  344.  
  345. - Screen To Back    (J) Move VLT behind all other screens/windows.
  346.  
  347. - Select Screen Type    Select type of screen.
  348.   - Custom Screen
  349.   - Workbench
  350.   - Interlaced
  351.   - Non-Interlaced
  352.  
  353. - Number of Colors      Select the number of colors.
  354.   - 2
  355.   - 4
  356.   - 8
  357.   - 16                  The use of 16 colors is not recommended.
  358.  
  359. - Select Colors     (U) Bring up a Palette requester to adjust colors.
  360.  
  361. - Lock Colors       (K) ***> Disallow the host to modify the current color
  362.                         values. <***
  363.  
  364. - Mask Colors       (M) ***> Draw only in the bitplanes necessary for the
  365.                         currently selected pen. <***
  366.  
  367. - Close Screen      (\) Close the graphics screen.
  368.  
  369.  
  370. 1.12 (Tek) Control Menu
  371. -----------------------
  372.  
  373. - Lock Graphics           (;)   ***> Disallow switching to the graphics screen
  374.                                 when receiving Tektronix control
  375.                                 characters. <***
  376.  
  377. - Return to Alpha-Numeric (F)   Return to Alpha-Numeric screen.
  378.  
  379. - Set Preferences         (T)   Set various Tektronix options.
  380.  
  381.  
  382.  
  383.  
  384.  
  385. 2. VLT's Script language
  386. ========================
  387.  
  388.         Below is a list of commands VLT currently recognizes. The names are
  389. none too pretty, but hey, the original code isn't my own... Typically, the
  390. commands take one argument, which can be a string, a number, a keyword or a
  391. boolean value. Boolean values are written ON or OFF, or equivalently YES or
  392. NO.
  393.         The commands work in the context of a regular VLT script (by
  394. convention called a .scp file). All commands save five are also recognized
  395. when they come from a REXX script (please use the extension .vlt). Some may
  396. not work: this part has not been tested very well. The five commands that
  397. have no effect when used in a REXX script are: EXIT, GOTO, DELAY, WAIT and
  398. ON. Also, since the RX command itself is SCRIPT ONLY and REXX scripts cannot
  399. be used as init files, REXX scripts can not run any INIT ONLY commands.
  400.         Note, that the script language is likely to change in a next version
  401. of VLT.
  402.         BIXmail me with any questions and I'll try to find out how something
  403. is supposed to work... (Did I mention the script stuff isn't originally my
  404. code?).
  405.  
  406.  
  407. Name          | argument values       | function
  408. --------------+-----------------------+-----------------------------
  409.  
  410. INIT only commands
  411. - - - - - - - - - -
  412.  
  413. BACkground      hex (e.g. 000, FFF)     Set background color (color 0)
  414. BOLd                                    Set bold color       (color 2)
  415. COL4                    "               Set color 4
  416. COL5                    "               Set color 5
  417. COL6                    "               Set color 6
  418. COL7                    "               Set color 7
  419. CURsor                  "               Set cursor color     (color 3)
  420. DEPth                   "               Set screen depth 
  421. FOReground              "               Set foreground color (color 1)
  422. INTerlace       ON/OFF, YES/NO          Interlace ON/OFF
  423. SCReen          W, C                    Screen, Workbench/Custom 
  424. TEK_load        ON/OFF, YES/NO          Preload Tektronix screen
  425. WB_colors       ON/OFF, YES/NO          Use Workbench colors
  426.  
  427. Script only commands
  428. - - - - - - - - - - -
  429.  
  430. ACTivate        V, T                    Move VT100/Tektronix Screen to front
  431. BEEp            none                    Beep
  432. CAPture         "filename"              Capture to a file
  433. CAPture         OFF, SUSPEND, RESUME    Capture off, suspend/resume capture
  434. CD              "new path"              Change directory
  435. DELay           integer (seconds)       Delay number of seconds
  436. EMIT            "string"                Display line on screen
  437. FLush                                   Flush ascii capture buffer to disk
  438. GOTo            "labelname"             Goto label
  439. INITXPR         "init string"           Initialize an External Protocol
  440. KB              none                    Kermit bye (for server)
  441. KG              "filename"              Kermit get file
  442. KR              none                    Kermit receive file
  443. KS              "filename"              Kermit send file
  444. ON              "string" "command"      On a 'string' do a command
  445. RAWEMIT         "string"                Display line, no escape parsing
  446. RAWSEND         "string"                Send string to host, no escape parsing
  447. RX              "Rexx command string"   Do a REXX string command
  448. SB              none                    Send a break
  449. SEND            "string"                Send string to host
  450. SRX             "Rexx command string"   Do a REXX string command and wait
  451. WAIT            "string"                Wait for a host string
  452. XPR             SENd,RECeive "filename" XPR send/receive a file
  453. XR              "filename"              Xmodem receive file
  454. XS              "filename"              Xmodem send file
  455.  
  456. Generally available commands
  457. - - - - - - - - - - - - - - -
  458.  
  459. APPlication     ON/OFF, YES/NO          Turn app. cursor on/off
  460. BAUd            integer (110 - 19200)   Set baud rate
  461. BREaktime       integer (microseconds)  Set break time
  462. BTAb_shift      ON/OFF, YES/NO          Shift-tab sends <ESC>-tab
  463. BUFfer          integer (512 - 2048)    Set buffer size 
  464. DESTBS          ON/OFF, YES/NO          Set destructive backspace
  465. DOWncase        ON/OFF, YES/NO          Kermit: downcase filenames
  466. ECHo            ON/OFF, YES/NO          Turn echo on or off
  467. ECHOLF          ON/OFF, YES/NO          Local echo: echo CR/LF when CR pressed
  468. EXIt            none                    Exit script file
  469. EXIt            QUIET                   Same without Script Completed message
  470. EXIt            VLT                     Exit VLT (can be dangerous!)
  471. F               integer "string"        Define function key
  472. HANdshake       N, X, 7, W              Handshake with serial
  473.                                            None, Xon/xoff, 7-wire, 7 + X
  474. HEIgth_cursor   integer (pixels)        Set cursor height
  475. KERmit_flags    S, H                    Set kermit flags
  476.                                            Send/receive, Host is server
  477. KEYscript_char  hex value (e.g. 7E)     Keyscript character
  478. KMAXPACK        integer (bytes)         Maximum Kermit packet size
  479. LFHelp          ON/OFF, YES/NO          Help key sends LF
  480. LINes           integer                 Number of lines 
  481. LOCk_graphics   ON/OFF, YES/NO          Disallow changing to graphics mode
  482. MESSage         "Message"               Post a message on VLT's screen/window
  483. MODe            C, N, I                 N, I = None, Image; C = convert CR/LF
  484. MOUse_to_host   ON/OFF, YES/NO          Convert mouseclicks to arrowkeys
  485. NUMKEYpad       ON/OFF, YES/NO          Turn numeric keypad on/off
  486. PARITY          N, E, O, M, S           Set parity
  487.                                            None, Even, Odd, Mark, Space
  488. PREScroll       integer                 Maximum number of lines of prescroll
  489. RENDer          Q, N, C, A              Rendering mode
  490.                                            Quick, Normal, Color, ANSI
  491. SENDLF          ON/OFF, YES/NO          Send CR/LF when CR is pressed
  492. SER             "device name" integer   Change the serial device and unit used
  493. SETXPR          "XPR name"              Set a particular external protocol
  494. STRIP           ON/OFF, YES/NO          Strip bit 8 when 8-bit parity mode
  495. SWAP_bs_del     ON/OFF, YES/NO          Swap BS and DEL
  496. VOLume          integer                 Set beep volume
  497. VPFkeys         ON/OFF, YES/NO          Screen (virtual) PF keys
  498. WIDth           integer                 Number of columns 
  499. WRAP            ON/OFF, YES/NO          Turn wrap on or off
  500. XFEr_protocol   X, K, A                 Set transfer protocol
  501.                                            XMODEM, Kermit, External
  502. XMOdem_flags    N, 1, C, 1C             Set xmodem flags
  503.                                            1 = 1K blocks, C = CRC
  504.  
  505.         Script commands that require a string in their argument now allow a
  506. different unquoting convention. When the string is preceded wit two quote or
  507. double-quote characters, the rest of the string until the end of the line is
  508. considered to be the argument. This allows one to embed any number of quotes
  509. in the string. Previously, VLT would parse on the first quote sign and stop
  510. parsing on the next matching quote sign, which is still the behavior if the
  511. string starts with a single quote or double-quote. In combination with the
  512. RAWSEND and RAWEMIT commands described above, one can now display or send any
  513. ASCII character (except NULL).
  514.  
  515.  
  516.  
  517. 3. Other changes in VLT
  518. =======================
  519.  
  520.  
  521.         What follows is a brief description of other changes that were made to VLT
  522. since version 3.656. 
  523.  
  524.  
  525. 3.1 Bug fixes
  526. -------------
  527.  
  528.  
  529. A. VT100 part:
  530. - - - - - - - -
  531.  
  532.         The audible beep was modified such that it will not allocate any
  533. audio channels unless the the beep function is invoked. This allows VLT to
  534. multitask with such programs as Sonix.
  535.         Some bugs were fixed in case one attempted to switch to the graphics
  536. screen without sufficient memory being available. VLT should no longer crash
  537. under those circumstances.
  538.         The problem where VLT would sometimes use the Topaz 60 font instead
  539. of Topaz 80 at 11 point is fixed. This problem did not show up when using
  540. FastFonts.
  541.         In some cases, VLT used to look for .scp files in the s: directory,
  542. rather than the rexx: directory where they are now kept routinely. This was
  543. fixed. VLT still looks for VLT.init (although pretty much obsolete), and
  544. VTPrefs.dat and TekPrefs.dat in s:.
  545.         Although VLT used to run fine on 68020 based Amigas, it used to crash
  546. when the SetCPU program had been run with the TRAP option. This is now fixed.
  547.         A problem with saving VTPrefs.dat files to the current default
  548. directory when one in s: existed, was fixed.
  549.         VLT now correctly reads the meaning of the Interlace field in the
  550. current Preferences structure. It used to be confused by bits set in that
  551. field by alpha versions of the 1.4 operating system.
  552.         In some versions of VLT the wrap function used to eat one character.
  553. This is now fixed.
  554.         A bug in the code for the various requesters was fixed. It would only
  555. show up and crash the machine if some misbehaving program had changed the
  556. value at address 0.
  557.         VLT's screens used to have no 'DefaultTitle'. These titles are now
  558. the same as the shared screen names.
  559.  
  560.  
  561. B. Tektronix part:
  562. - - - - - - - - - -
  563.  
  564.         Echoplex suppression is now performed on reports to the host.
  565.         A small problem with the block cursor was fixed: it sometimes didn't
  566. appear when needed.
  567.         As indicated above, the crashes when changing to graphics mode in low
  568. memory situations should be fixed now.
  569.         Because of additions to the Graphics menus it was necessary to change
  570. the TekPrefs.dat file format. The message indicating that your TekPrefs.dat
  571. file was obsolete used to appear on the VT100 screen. It now correctly
  572. appears on the Tektronix screen. If you have an obsolete TekPrefs.dat file,
  573. select Set Preferences from the Control menu and click on the Save gadget.
  574. That should write a new TekPrefs.dat file.
  575.         A problem was found with handling text. The limited 4105 emulation
  576. requires that at least 80 columns be displayed on the screen, whereas strict
  577. 4010/14 only allows 73 columns of text. I decided to change the emulation in
  578. favor of 4105 compliance: it now has a text pitch that allows 80 columns to
  579. be displayed. This is unfortunately not backwards compatible.
  580.         The escape sequence <ESC> ?, while implemented in previous versions
  581. of VLT, apparently has never worked. This problem was fixed. It only affected
  582. operation with mainframe applications that would use this sequence instead of
  583. sending the <DEL> character (ASCII 127).
  584.  
  585.  
  586. 3.2 Enhancements
  587. ----------------
  588.  
  589.  
  590. A. VT100 part:
  591. - - - - - - - -
  592.  
  593.         There are a number of new menu options, as we've seen already in 
  594. section 1. One new menu option is Open Console in the VLT menu. It opens a
  595. little ConMan console window at the bottom of the screen. You can proceed to
  596. type lines of text there instead of in the main VLT window. This has
  597. advantages and disadvantages: you do have command history and you can edit
  598. the line before  sending it. Also, you can prefix the line with the keyscript
  599. introducer (typically a tilda) and execute any of VLT's script commands. But
  600. on the other hand, while this window is active you cannot use VLT's menus or
  601. function keys, and such things as ctrl-S and ctrl-Q don't work either. For
  602. those you will have to click in VLT's main window to activate it.
  603.         Also new are the options to set the serial device and unit to use,
  604. though these are only of interest to people that have additional serial ports
  605. such as the ASDG Twin-X board.
  606.         The ANSI color option in the Rendering Mode menu item is there to
  607. allow VLT to work with certain bulletin board systems that support ANSI color
  608. sequences. If the color option is selected, some of the ANSI sequences are
  609. interpreted differently from ANSI standards unless the ANSI color option is
  610. also selected. 
  611.         The menu options CR-Key: Send CR/LF and CR-Key: Echo CR/LF affect the
  612. behavior of the <return> key: normally, the return key just sends a return
  613. character, and when in local echo mode, only a return is displayed on the
  614. screen. With the Send CR/LF option set, VLT will send both a return and a
  615. linefeed to  the host. When Echo CR/LF is set, VLT will (in local echo mode)
  616. echo both a return and a linefeed.
  617.         The action performed when VLT needs to beep is now more programmable.
  618. Already, the user could set VLT to use the usual screen flash technique by
  619. setting the beep volume to 0. An audible beep is used when the beep volume is
  620. set to a value between 0 and 64 (or to between 0 and -64 for a higher pitched
  621. beep). Now however, the beep function is truely programmable. When VLT is set
  622. to Program Mode On, and you select Beep Volume, a requester pops up to ask
  623. you which command to execute when a beep is needed. My favorite command
  624. currently is
  625.  
  626.         ~srx "address 'PingServer' beep"
  627.  
  628. This executes a VLT command (srx) which sends the BEEP command to a host with
  629. the name 'PingServer', which in turn starts sounding a nice 'Ping' sound. In
  630. this context, the difference between  rx  and  srx  should be discussed: rx
  631. sends a command to ARexx and then goes on to do other things, while srx does
  632. the same,  but waits until ARexx indicates the command was completed. This
  633. synchronous behavior allows one to sequence ARexx commands correctly, and
  634. this is one of the reasons srx is used in the above instead of rx.
  635.  
  636.         There are various new script commands, see section 2. The ASCII
  637. capture facility was modified substantially and bears closer inspection. The
  638. menu options "Capture Session" and "End Capture" still work the same way:
  639. when first selected, the "Capture Session" option displays a file requester
  640. to allow the user to enter the name of a file to capture to. Selecting ths
  641. option again suspends capture, and subsequent selection resumes capture. "End
  642. Capture" closes the current capture file. New here is that if on first
  643. selection, the selected file already exists, the user is asked whether to
  644. append, overwrite or abort the capture attempt (see secion 1). The
  645. corresponding script command "CAPture" was also modified.  "CAPture
  646. <filename>" now starts a new capture file, overwriting the file if a file of
  647. the given name already existed. From a script, capture can now be supended,
  648. resumed and turned off by "CAPture SUSPEND", "CAPture RESUME" and "CAPture
  649. OFF" respectively, while the "FLUSH" (not "CAPture FLUSH"!) command only
  650. flushes the current buffer to disk (or wherever it is written) without
  651. suspending or closing the capture file. This implies, that certain file names
  652.  have now become illegal: you cannot call your files SUSPEND, RESUME or OFF.
  653.         At the request of many users, the EXIT script command can now be used
  654. with the QUIET parameter, in order to prevent VLT from displaying the "Script
  655. Completed" message.
  656.  
  657.         A new escape sequence was introduced to allow the host to send a
  658. script command to be executed by VLT. Together with VLT's 'rx' script
  659. command, this  allows one to execute ARexx scripts on command by the host.
  660. The syntax is:
  661.  
  662.    <start-of-VLT-command><SystemPassWord><VLT command><end-of-VLT-command>
  663.  
  664. where
  665.  
  666.    <start-of-VLT-command> = <CSI>?91h
  667.    <end-of-VLT-command>   = <CSI>?91l
  668.    <SystemPassWord>       = current value of environment variable
  669.                             "SystemPassWord"
  670.    <VLT command>          = a valid VLT script command
  671.    <CSI>                  = <ESC>[ or ASCII command sequence introducer
  672.                             character
  673.    <ESC>                  = ASCII escape character
  674.  
  675. An example would be:
  676.  
  677.    <esc>[?91hMyAmigaPassword~rx "address
  678.                                  command 'WLens 100 100 VLT'"<esc>[?91l
  679.  
  680. The sequence of events in VLT, on receipt of this string from the host would
  681. be: VLT would enter "command capture" mode after receiving the h of the
  682. escape sequence, it would then store every incoming printable ASCII character
  683. (with a maximum of 255 characters) until the <esc> character of the
  684. end-of-command sequence in a buffer; it would then compare the first part of
  685. the string with the current value of the environment variable SystemPassWord
  686. on the Amiga, and if the two match, execute the rest of the string as a
  687. standard VLT command. In this case, it would find the tilda, indicating that
  688. this is indeed a VLT script command, and it would send the command "address
  689. command 'WLens 100 100 VLT'" to ARexx, which, if WLens is installed would
  690. open the WLens window on VLT's screen. The requirement of the SystemPassWord
  691. is for security reasons. Obviously, an ill-intending person on a
  692. not-too-secure mainfram could send you a command to reformat your hard disk.
  693. Now, if the password does not match the current value of the environment
  694. variable called SystemPassWord, you wil get a notice on your screen saying
  695. that a command was sent to you, and it will also show the first part of that
  696. command. If there is no such environment variable, the command will always
  697. fail this way.
  698.  
  699.         This version of VLT has support for external file transfer protocols
  700. that comply with the XPR standard, now in the process of being set. In the
  701. Transfer menu, one of the available protocols is now "External". When you
  702. select this option, a file requester will appear showing you all available
  703. XPR libraries. Currently, the only one you will find is "xprascii.library", a
  704. simple external protocol that takes the place of the ASCII upload facility
  705. that used to be in that place in the menu. When you select this library as
  706. your upload protocol, you can then select the External Options item in the
  707. Transfer menu, and you will find a requester asking you for the amount of
  708. delay to be inserted after each 80 character packet sent to the host. When
  709. you have selected that (say 50 ticks), you can proceed as you would in
  710. previous versions of VLT: select Send File to upload a file to the host,
  711. select Receive File to find out that you should use capture. Notice, that
  712. when you have selected an external protocol, and you save your configuration,
  713. the name of the protocol is also stored, and the next time you run VLT that
  714. protocol is selected. Notice also that the External Protocol options string
  715. is NOT saved.
  716.  
  717.         VLT now has a number of new command line options. The full syntax is:
  718.  
  719.         1> VLT [-i]
  720.                [+i <init-script-name>]
  721.                [+s <serial-device-name>]
  722.                [+u <unit-number>]
  723.                [+n <vlt-port-name>]
  724.                [<script-1> [<script-2> ... [<script-n>]]]
  725.  
  726. All these parameters are optional. As an example, let's consider what the 
  727. command:
  728.  
  729.         1> VLT -i +s siosbx.device +u 1 +n VLT2 myscript.scp
  730.  
  731. does. The -i tells VLT not to look for a vlt.init file. The +s options tells
  732. VLT to use siosbx.device instaed of the normal Amiga serial.device (but the
  733. device MUST look identical to the Amiga's serial device!), whereas the +u
  734. option tells VLT to use unit 1 of that device. The +n option tells VLT that
  735. it should use VLT2 for everything where it would normally have used VLT. This
  736. means that the shared screen names will be VLT2 and VLT2TEK for the VT100 and
  737. graphics screens respectively and that the ARexx port will be named VLT2. And
  738. finally, VLT will start running  myscript.scp once it has started up. Notice,
  739. that withthe +s and +n options, it is now possible to run more than one copy
  740. of VLT at the same time. Again, this is only useful if you have more than one
  741. serial port. Notice, that when you save your configuration, all of these
  742. settings (serial device name, unit, and port name) will also be saved.
  743.  
  744.         Other enhancements include:
  745. - The Quick Rendering Mode is now allowed on the Workbench.
  746. - The status windows for file transfers have a much nicer format.
  747. - VLT now checks if it is already running and brings the running version to
  748.   the front.
  749. - VLT now scrolls even faster.
  750. - VLT now works with characters above 127 in the ASCII character set. In
  751.   particular, the character $9B is now recognized as <CSI>.
  752. - VLT now sounds a bell/flashes the screen twice after up- or downloads.
  753. - VLT windows are now sizable and draggable and depth arrangeable when used
  754.   on the Workbench. One problem may be that on a standard size Workbench (no 
  755.   morerows) VLT no longer can fit 80 columns. Solution: use morerows.
  756. - The cursor height can now be changed from the menu.
  757. - The Auto-Screen-to-Back menu option brings the Workbench to the front during
  758.   file transfers.
  759. - The emit command was modified to emit its argument string in a manner
  760.   identical to text coming from the serial device, for greater speed.
  761. - Support for 110 baud was added.
  762.  
  763.  
  764.  
  765. B. Tektronix part:
  766. - - - - - - - - - -
  767.  
  768.         In the Tektronix emulation, the most notable additions have been in
  769. the Image menu: VLT now supports saving the current picture as a bitmap in
  770. IFF form, or the vectors themselves in Encapsulated PostScript form. Also,
  771. printing the bitmap as a graphics dump is now supported in four different
  772. sizes. When the Tektronix emulation is busy doing something, it will show a
  773. BUSY pointer, and it will no longer flash or beep at the end.
  774.         A Mask Colors option was added. This option changes the way in which
  775. the picture is redrawn. When Mask Colors is in effect, graphics are drawn
  776. only in the bitmaps needed for the particular color index. This allows you to
  777. draw in  separate bitplanes without erasing the contents of other bitplanes.
  778. By carefully selecting which color index to draw with, you can herewith
  779. determine which color is used for areas where two lines of different color
  780. overlap.
  781.  
  782.         Other enhancements:
  783. - when the Numeric option is selected for the graphics cursor, the X and Y
  784.   coordinates are now displayed in a separate window when the graphics cursor
  785.   is active.
  786. - The Tektronix window now has a Lock Graphics option, just like the VT100 
  787.   window. This option will set the graphics lock and switch to the VT100
  788.   window.
  789. - Many more menu options have command key abbreviations.
  790. - The current picture will now be redrawn automatically whenever an operation
  791.   has changed the window or screen.
  792. - A Lock Colors option has been added. It prevents the host from changing the
  793.   colors you had just set so carefully.
  794. - The escape parser was rewritten and now eats most 4105 escape sequences
  795.   without leaving traces.
  796.  
  797.  
  798.                         ----------------------
  799.